CygNet FMS Node Chooser Control

Node Chooser control icon The CygNet FMS Node Chooser Control is an ActiveX control that serves as the primary data navigation control in CygNet Measurement. Use the Node Chooser control to select Nodes by group, Node category, or name, in order to filter the available Nodes down to a manageable number.

See Using the Node Chooser Control for more information about configuring and using this control.

See CxFmsNodeChooserCtrl Object in the Scripting section for more information about scripting this control.

Adding a Node Chooser Control to a Screen

To Add and Configure a CygNet FMS Node Chooser Control in CygNet Studio

  1. Create a new CygNet Studio screen.
  2. Click the ActiveX tool ActiveX on the Standard Tools palette.
  3. Click and drag the outline of a box on the screen. When the mouse button is released, an Insert OLE Control dialog box appears.
  4. In the dialog box, double-click on CygNet FMS Node Chooser Control to place a Node Chooser control on your screen.
  5. Right-click the control to open its property sheet.
  6. On the ActiveX page, click ... or double-click (OCXProperties) to access the CygNet FMS Node Chooser Control Properties dialog box.
  7. The CygNet FMS Node Chooser control contains a General tab and a Commands tab.
  8. Configure properties on each page as desired, click Apply, and then click OK.
  9. Close the property sheet, save, and then switch to Run mode to use the control.

General Properties

The General page of the CygNet FMS Node Chooser Control Properties dialog box contains the following properties.

General Properties

General Properties

Property Description
General

FMS service

Type the name of the Site.Service, or click ... to access the Select Service dialog box to select a service, to which to connect to retrieve Node options for display in the Chooser.

Use Point in Time mode

Click the check box to select/clear the option to use the Point in Time mode.

PIT (C)

If Use Point in Time mode is selected, do one of the following.

  • Type the desired date/time value into the text box.
  • Click ... to access the Select Date and Time dialog box, then enter the date/time, in Contract time (C), from which you want to view data.

Default value is T, date and time today.

See Using the Home Menu for more information about PIT mode.

Node Chooser

Allow FMS service selection

Click the check box to select/clear the option to show the FMS service selector in the Chooser.

Allow Node category selection

Click the check box to select/clear the option to show the Node category selector in the Chooser.

Allow multiple selections

Click to allow multiple selection of Nodes in the Chooser.

Node category

Select the desired Node Category to display in the Chooser from the drop-down menu.

Options are as follows.

  • <Any> - any available Node category
  • Group
  • Device
  • Gas Device
  • Liquid Device
  • Accessory
  • Station

Node group

Select the desired Node Group type to display in the Chooser from the drop-down menu.

Options are as follows.

  • <All Nodes>
  • General
  • Station
  • By Category

Filter

First type a partial string of known Node name/description/ID characters to populate the filter text box.

Wildcard values * (multiple character) and ? (single character) are supported.

Default value is * (multiple character wildcard) - all.

Note: Wildcards can be used only when filtering by Name or Desc, not when filtering by ID.

Then select a Node option to filter for results.

Options are as follows.

  • Name
  • Desc
  • ID

Primary column

Select the desired primary sort column in the Chooser from the drop-down menu.

Options include the following

  • Type ascending
  • Name ascending
  • Description ascending
  • Type descending
  • Name descending
  • Description descending

Default value is Name ascending

Button text

Type the text for the button in the status bar of the Node Chooser control.

Allowable characters (maximum of 20) are A-Z, a-z, 0-9, . (period), #, $, &, (, ), +, -, \, /, :, <, >, =, @, [, ], ^, {, }, _ (underscore), !, ~ (tilde). Spaces are acceptable, when they are not leading or trailing.

See Using the Node Chooser Control for more information about configuring these properties.

Commands Properties

The Commands page of the CygNet FMS Node Chooser Control Properties dialog box contains the following options.

Commands Properties

Commands Properties

See Managing Node Commands for more information about configuring commands for the FMS Node Chooser control.


More:

Back to top